package cn.bin758.h5game.module.game.service.record;

import java.util.*;
import javax.validation.*;
import cn.bin758.h5game.module.game.controller.admin.record.vo.*;
import cn.bin758.h5game.module.game.dal.dataobject.record.RecordDO;
import cn.bin758.h5game.framework.common.pojo.PageResult;

/**
 * 对局信息 Service 接口
 *
 * @author bin758
 */
public interface RecordService {

    /**
     * 创建对局信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createRecord(@Valid RecordCreateReqVO createReqVO);

    /**
     * 更新对局信息
     *
     * @param updateReqVO 更新信息
     */
    void updateRecord(@Valid RecordUpdateReqVO updateReqVO);

    /**
     * 删除对局信息
     *
     * @param id 编号
     */
    void deleteRecord(Long id);

    /**
     * 获得对局信息
     *
     * @param id 编号
     * @return 对局信息
     */
    RecordDO getRecord(Long id);

    /**
     * 获得对局信息列表
     *
     * @param ids 编号
     * @return 对局信息列表
     */
    List<RecordDO> getRecordList(Collection<Long> ids);

    /**
     * 获得对局信息分页
     *
     * @param pageReqVO 分页查询
     * @return 对局信息分页
     */
    PageResult<RecordDO> getRecordPage(RecordPageReqVO pageReqVO);

    /**
     * 获得对局信息分页
     *
     * @param pageReqVO 分页查询
     * @return 对局信息分页
     */
    PageResult<RecordDO> getRecordPage2(RecordPageReqVO pageReqVO);

    /**
     * 获得对局信息列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 对局信息列表
     */
    List<RecordDO> getRecordList(RecordExportReqVO exportReqVO);

}
